1 




LEVEL6 

V^l SOFTWARE 


LEVEL 6/ 

BSC 2780/3780 
FILE 

TRANSMISSIOK 

FACILITY 

















SERIES 60 (LEVEL 6) 
LEVEL 6/BSC 2780/3780 
FILE TRANSMISSION FACILITY 

USER’S GUIDE 


SUBJECT 

A Detailed Description of the Series 60 (Level 6) File Transmission Facility 
Between Honeywell Level 6 and Non-Honeywell Processors Using BSC 2780/ 
3780 Protocol 


SPECIAL INSTRUCTIONS 

This revision supersedes Revision 0 of the manual dated January 1978. Change 
bars in the margin indicate additions and changes; asterisks indicate deletions. 


SOFTWARE SUPPORTED 

This publication supports Release 0110 of the Series 60 (Level 6) GCOS 6 
MOD 400 Operating System. See the Manual Directory of the latest GCOS 6 
MOD 400 System Concepts manual (Order No. CB20) for information as to later 
releases supported by this manual. 


ORDER NUMBER 
CB38, Rev. 1 


June 1978 


Honeywell 



PREFACE 


This manual describes the GCOS 6 File Transmission Facility 
for transmitting data between the Honeywell Level 6 and non- 
Honeywell host computer systems. Unless stated otherwise, the 
term GCOS refers to GCOS 6 software; the term Level 6 refers to 
Series 60 (Level 6) hardware on which the GCOS software executes. 

GCOS 6 configuration information for the File Transmission 
Facility is explained in the System Building manual. 

I Section 1 of this manual is an introduction to the Level 6/ 

BSC 2780/3780 File Transmission Facility. 

Section 2 is a detailed description of file transmission 
functionality, while Section 3 details file transmission opera¬ 
tion . 

Appendix A contains a listing of file transmission messages. 
Appendix B describes the ASCII and EBCDIC character sets. 
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SECTION 1 


INTRODUCTION 


File transmission provides the capability of transmitting 
files between a Level 6 processor and a remotely located IBM 
host processor using a binary synchronous (BSC) line discipline 
(see Figure 1-1). The Level 6 converts data from its native 
ASCII code to the IBM EBCDIC code for transmission to the host. 

File transmission is controlled through the use of a standard 
operating system command. A versatile and extendable command 
line format provides a multifunctional transmission repertoire 
with default options available to allow shorter command lines. 



Figure 1-1. 


Level 


6/BSC 2780/3780 


File Transmission 


FILE TRANSMISSION UTILITY PROGRAM (TRANB) 


The file transmission utility program (TRANB) operating on 
the Level 6 provides data file transmission and performs a series 
of communications functions, as follows: 


o Multiple concurrent transmissions over separate 
communications lines 
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o Error reporting (error messages are described in 
Appendix A) 

o Extensive pre-/post-analysis and processing, including: 

- Command statement and parameter validity checking 

- Level 6 to host connection validation 

- Memory allocation and size determination 

- File interrogation and buffer allocation 

- Host dialog for file verification and/or creation 

- Buffer and record size monitoring for oversize 
transmissions 

- Termination reporting including error information and 
final record number 

- Conversion of data to EBCDIC 

The TRANB file transmission utility program is described in 
detail in Sections 2 and 3. 


FILE ORGANIZATION 

Disk files are transferred between the Level 6 and the host. 
The files transmitted can contain records of any length, since 
the TRANB "cut and paste" facilities (see Section 3) appropri¬ 
ately process the file records for transmission. 


LINE PROTOCOL 


The Level 6 processor transmits files to/from a host 
processor that uses the BSC 2780 or 3780 line protocol to control 
data interchange. For details, see the Communications 
Processing manual. 


T 1 no 


11. UV. JL X* 


o Synchronous 
o Half/full duplex 

o Support of a BSC 2780/3780 line protocol 
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o Dedicated/switched (dialup; see Section 3) 
o 2000 to 9600 baud line speed 

CODE CONVERSION 

The Level 6 converts data from its native ASCII code to the 
IBM EBCDIC code for transmission to the host. Received files are 
converted from EBCDIC to ASCII. 


RESOURCE REQUIREMENTS 

The Level 6 system must have the following resources to 
perform file transmission. 


o Level 6 central processor 
o Multiline communications processor 
o Synchronous communications line adapter(s) 
o Communications resources: 


1. Data set.(s) - Bell system 201A, 201C, 208B, modem 
bypass, or equivalent 

2. Electrical characteristics - standard RS-232-C 

3. Transmission mode - synchronous, two-way alternate 

4. Code set - EBCDIC 


o Configuration Load Manager with communications extensions 

o Communications subsystem configured with BSC 2780 or 3780 
line discipline 

o GCOS 6 MOD 400 Operating System with File Manager 

o TRANB file transmission utility program (8K memory) 

For each concurrently active file transmission, the 
minimum memory for one stream is as follows: 


- BSC 2780 protocol: 

8K (8192 words) 
.625K ( 640 words) 
.125K ( 128 words) 
8.75K (8960 words) 


TRANB 

buffer and work areas 

one file record buffer (default) 

minimum memory for one stream 
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BSC 3780 protocol: 


8K (8192 words) 
1.33K (1360 words) 

»125K ( 128 words) 

9.45K (9680 words) 


TRANB 

buffer and work areas 

one file record buffer (default) 

minimum memory for one stream 


IBM HOST CONFIGURATION REQUIREMENT 

The BSC 2780 communications line must be configured without 
horizontal tab, transparency, or multibuffering on the host. 
Alternately, when utilizing the BSC 3780 protocol, the communi¬ 
cations line must be configured without transparency or multi¬ 
buffering on the host. For configuration information see the 
System Building manual. 



SECTION 2 


FILE TRANSMISSION FUNCTIONALITY 


ACTIVATING FILE TRANSMISSION 


Prior to the initial connection between the Level 6 and the 
host, perform the following actions: 

1. Mount the appropriate disk files (packs). 

2. Initialize the GCOS 6 operating system as prescribed in 
the System Building manual. 

3. Invoke the file transmission utility program (TRANB) at 
the Level 6 end of the communications network. (The invo¬ 
cation of TRANB is described in Section 3.) 

NOTE: A task group is required for each transmission 

in order to execute simultaneous file transfers 
(see the System Building manual). 

Once these steps are taken, begin the communications 
accessing procedure (see Section 3). 


INITIATING TRANSMISSION 

The Level S operator specifies directives for the transmis¬ 
sion of files to and from the host by issuing the TRANB command 
(see Section 3). TRANB can also be called directly from a user 
program by the Command Line Process ($CMDLN) macro call. (For 
details, see the System Service Macro Calls manual.) 

In the context of file transmission, the Level 6 is called 
the "initiator", while the host is called the "acceptor"; either 
can send or receive data. 


FUNCTIONAL DESCRIPTION 

Figures 2-1 through 2-3 illustrate the logical protocol 
sequence involved in the transmission (send/receive) of files 
between the Level 6 and the IBM host processor. 
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Once the TRANB command has been invoked, the message TRAN 
yddd (yddd is the Julian date (year, day) of the software revi¬ 
sion) is sent to the user-out file. The initiator's file (Level 
6 file) is then opened and the host connection established. 

After connection, the signon card (if required) is transferred to 
the host and the Level 6 is readied for reception of any host 
status or informational messages. Any transmission received from 
the host at this time (normally job status) is directed to the 
user-out file. Next the file transfer takes place. This is 
indicated by the TRAN ESTABLISHED message. 

Termination processing is performed at the conclusion of the 
data transfer process. The line is physically disconnected if 
D is specified in the TRANB command. The files are closed, the 
termination message nnnnn RECORDS TRANSFERRED is displayed, and 
TRANB terminates. 


TERMINATING COMMUNICATION 


Termination of transmission can occur as follow's: 

1. Logical termination of communications is initiated by 
TRANB at the completion of the file transmission session 
(see Section 3). 

2. Error conditions result in the abnormal termination of 
file transmission (see below). 


Error Messages 


When either the Level 6 utility or the host detects an error, 
an error message is displayed on the user-out file at the 
Level 6. 

When TRANB detects or is informed of an error, it disconnects 
the Level 6 from the communications line and terminates. Error 
messages are described in Appendix A. 
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DIRECTION OF TRANSFER - LEVEL 6 TO 
IBM HOST (LINE NOT PHYSICALLY CONNECTED) 


( 


{ 



CONNECTION 


r 


DATA J 

TRANSFER } 




TERMINATION 


LEVEL 6 


SIGNON CARD 


DATA (INCLUDING NECESSARY JCL) 


80-CHARACTER RECORDS 






POSSIBLE PRINT OUTPUT OF JOB 


144-CHARACTER (MAXIMUM) RECORDS 




LINE IS PHYSICALLY DISCONNECTED IF D 


(DISCONNECT) ARGUMENT IS SPECIFIED IN 
TRANBCOMMAND 


IBM HOST 


I 


Figure 2-1. File Transfer 
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DIRECTION OF TRANSFER - LEVEL 6 TO 
IBM HOST (LINE ALREADY PHYSICALLY 
CONNECTED) 


DATA 

TRANSFER 



TERMINATION 



Figure 2-2 


File Transfer Protocol Two 



DIRECTION OF TRANSFER - IBM HOST TO LEVEL 6 


CONNECTION 


r 


DATA J 

TRANSFER 1 


V 


TERMINATION 


LEVEL 6 


SIGNON CARD 


AND NECESSARY JCL TO CAUSE HOST TO 
TRANSMIT DATA 


DATA 






DATA RECORDS 

WITH LEADING PRINTER CONTROL CHARACTER ARE 
AUTOMATICALLY SENT TO USER-OUT FILE 


PRINT OUTPUT OF JOB 






144-CHARACTER (MAXIMUM) RECORDS 


LINE IS PHYSICALLY DISCONNECTED 
IF D IS SPECIFIED IN TRANB COMMAND 


IBM HOST 


* 


Figure 2-3 
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SECTION 3 


OPERATING PROCEDURES 


The TRANB program runs on the Level 6 system and is designed 
to establish access connection with the host through a communica¬ 
tions procedure. The Level 6, which specifies all directives for 
transmission of files in the TRANB command (see below), is called 
the initiator while the host is called the acceptor; either can 
send or receive data. 

Once the connection is complete, the TRANB program transfers 
files in accordance with the calling arguments specified in the 
TRANB command. After a file transfer has been performed, TRANB 
maintains the logical connection with the host if continue (C) 
is specified in the TRANB command; connection is broken if 
disconnect (D) is specified. 


TRANB COMMAND 


The operator typein for invoking TRANB is described below. 

The arguments for the TRANB command can be specified in any order 
but must be separated by spaces, as shown below. If you are 
transferring a number of files, you must enter the TRANB command 
for each file. Do not specify the continuation argument (C) 
before the last file being sent. In the following format 
description, brackets ([]) enclose optional arguments and under¬ 
lined arguments are the default values. The delta characters 
signify mandatory spaces. 



"s" 


Cl 1" f 278 ) r i 

TRANB A 

R 


[djA -L | 378 j A [pathname 



C 1 

-I 

1 PjApathname 

• 


A 


-NA 


lrn ) 

pathname^ 


A 
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Argument Descriptions 


S 

The Level 6 is to send data 
R 

The Level 6 is to receive data from the host (default 
value) 

C 


Communications line is to remain connected at the end of 
a file transfer in anticipation of another TRANB command 
issued by the operator indicating additional file trans¬ 
fers 


I 

I 

I 

i 


D 

Disconnect communications line at the end of the file 
transfer (default value) 

7278 \ 

-L {378 \ A pathname 

Specifies the IBM host using BSC 2780 or 3780 protocol. 
The pathname, if used, identifies the preliminary 
transfer file that is used to initiate the file 
transfer. This file is unnecessary for sending data 
to the host if the Level 6 is already connected to 
the host or can contain only the signon card (see 
below). If a file is to be received from the host, this 
file contains, in addition to the signon card if 
necessary, the appropriate job control language to 
activate the file transfer 

(irn ) 

-NAlpathnamel 

Either logical resource number (LRN) used to access the 
communications line or a pathname in the form >SPD>xxxx 
which is used by the file system to generate an LRN 
(see the System Concepts manual). (xxxx must have been 
identified in the Configuration Load Manager (CLM) file) 


-I 


A pathname 


Initiator's pathname identifying the file being sent/ 
received (see the System Concepts manual) 


Format: 



volname>directory[>directory...] 


> 


filename 




/if r 

! / 
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ADDITIONAL VALUES: 


C - Invokes the "cut" facility for file transmission 
from the Level 6 to the host; splits the file 
records into 80-character transmission blocks. 

See "Sending a File to Host (Cut Option)", later in 
this section. 

P - Invokes the "paste" facility for file transmission 
from the host to the Level 6; combines the 80-char¬ 
acter reception blocks from the host to form fixed- 
■* length records. See "Receiving a File from Host 
(Paste Option)", later in this section. 

Once the TRANB command is entered, and the TRAN yddd message 
appears on the user-out file, perform the necessary communication 
procedures to establish connection with the host. 

ESTABLISHING COMMUNICATION WITH HOST 

A Level 6 communicates with an IBM host over a communications 
line. The line can be either dedicated or nondedicated (dialup). 
The following procedure establishes the connection with the host: 

o For a dedicated line: 

Communication is automatically initiated by the TRANB 

program 

o For a dialup line, with the Level 6 running: 

1. Press the TALK button on the data set. 

2. Lift the handset and wait for the dial tone. 

3. Dial the assigned number for the host. If a busy 
signal is received, try another number or try again 
later. If no answer is received after several rings, 
the host is not accepting calls. Try later or contact 
the operator for a status report. 

4. When the high-pitched tone is received, press the DATA 
button on the data set and replace the handset. ,If a 
data connection is successfully made, the DATA button 
will light and remain lighted. Loss of the light on 
the DATA button indicates loss of the connection and 
the ability to send or receive data. 

JOB CONTROL LANGUAGE REQUIREMENTS 

The job control language (JCL) required to exchange data 
files with an IBM host is described below. Note that the specif¬ 
ic parameters and values used may vary with different IBM instal- 
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lations and may have to be modified. For a complete description 
of IBM job control language, see the IBM System/360 Operating 
System; Job Control Language Reference manual. 


JCL for Level 6 to IBM Host File Transfer 

The following example shows the job control language required 
to create a new file on an appropriate IBM host to receive data 
from a Level 6: 


// jobname 

JOB 

(job card) 

// A EXEC 

PGM= 

IEBGENER,REGION=7OK 

//SYSPRINT 

DD 

SYSOUT=A 

//SYSIN 

DD 

DUMMY 

//SYSUT 2 
// 

// 

DD 

DSN=filename,DISP=(,CATLG,DELETE),UNIT=SYSTS 
SPACE=(TRK, (1,1)) ,DCB=(RECFM=FB,LRECL=8 0, 
BLKSIZE=12960) 

//SYSUT1 

DD 

* 

Data cards 


/* 

// 


JCL for IBM Host to Level 6 File Transfer 

The following example shows the job control language required 
to identify the file on an appropriate IBM host that is to send 
data to a Level 6: 


//jobname 

//A EXEC 

//SYSPRINT 

//SYSIN 

//SYSUT 2 

//SYSUT1 

// 


JOB (job card) 

PGM=IEBGENER 
DD SYSOUT=A 
DD DUMMY 

DD SYSOUT=B,DCB=(RECFM=FB,LRECL=80,BLKSIZE=4240) 
DD DSN=filename,DISP=SHR 


Signon Card 

A signon card is required for file transmission with an IBM 
host whenever the communications line is initially dialed. The 
card format is : 
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/*SIGNON 


REMOTExx 


xx 


Specific remote number obtained for the IBM host 


SENDING A FILE TO HOST (NEW CONNECTION) 


To send a file to the host when a connection has not been 
established, the TRANB command must contain the following 
arguments: 


TRANB S 



- L 


2781 
3781 


pathname -N nn -I pathname 


The preliminary file identified by -Lxxx pathname must 
contain the signon card, while the file identified by -I pathname 
must contain both the JCL required to create a file at the host 
and the data to be transferred. 


SENDING A FILE TO HOST (CONNECTION ESTABLISHED) 


To send a file to the host when a connection already exists, 
the TRANB command must contain the following arguments: 


TRANB S 



f 278 ) 
-Lj 378 | 


-N nn -I pathname 


The file identified by -I pathname must contain the JCL 
required to create a file at the host, as well as the data to be 
transferred. A preliminary file containing a signon card is not 
required . 


SENDING A FILE TO HOST (CUT OPTION) 


To transfer a Level 6 file that has record lengths 
than 80 characters, the "cut" option is provided. For 
if the Level 6 file contains records of 100 characters 
TRANB will "cut" and combine the records to produce 80 
frames for transmission to the host, as follows: 


greater 
example, 
in length, 
character 


RECORD 1 


RECORD 2 


RECORD 3 


80-char 


20-char 


60-char 


40-char 


40-char 


60-char 


1ST FRAME 


2ND FRAME 


3RD FRAME 


ETC. 


The first three frames above are packed on the host processor 
as the first three records in the IBM host file. 
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To invoke the "cut" facility, you must include the C argument 
in the TRANB command, as follows: 


TRANB S 


C 

D 



pathname -N nn -IC pathname 


V_^ 


RECEIVING A FILE FROM HOST 


To receive a file from the host, the TRANB command must 
contain the following arguments: 


TRANB 



pathname -N nn -I pathname 


The preliminary file identified by -Lxxx pathname must 
contain the JCL that identifies the host file to be sent to the 
Level 6 and, if a connection has not been established, the signon 
card. The file identified by -I pathname is the Level 6 file in 
which the data received from the host is to be stored. When 
receiving data, the Level 6 overwrites an existing file if one 
with the proper name (that specified in -I pathname) is found. 

If none is found, a new file with a record size of 256 characters 
is opened. 


RECEIVING A FILE FROM HOST (PASTE OPTION) 


The "paste" option is provided for reception of an IBM host 
file onto a Level 6 file containing records of more than 80 
characters in length. When the Level 6 receives 80-character 
transmission frames from the host, TRANB slices and pastes the 
frames into the allocated record size of the Level 6 file. For 
example, if the Level 6 allocated record size is 100 characters, 
the following results: 


FRAME 1 FRAME 2 FRAME 3 


80-characters 


20-char 

60-char 


40-char 

40-char 



RECORD 1 RECORD 2 RECORD 3 


To invoke the "paste" facility, you must include the P argu¬ 
ment in the TRANB command, as follows: 


TRANB R 


{S} 


(278) 
-L 13781 


pathname -N nn -IP pathname 


(f " 
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TERMINATING COMMUNICATION 

Termination processing is performed at the conclusion of the 
data transfer sequence. The line is physically disconnected if 
the TRANB command line specifies the disconnect (D) argument. C 
in the command line indicates that the line remains connected. 


ABNORMAL TERMINATION 

If an error condition arises during any phase of file trans¬ 
mission, TRANB issues an error message to the user-out file indi¬ 
cating a transmission failure and physically disconnects the line 
if the disconnect argument was specified in the TRANB command. 

If the error was caused by a communications failure, the line is 
physically disconnected regardless of whether C or D was speci¬ 
fied in the TRANB command. The error message identifies the 
cause of the problem (see Appendix A). 


RESTART AFTER ABNORMAL TERMINATION 

Restart after abnormal termination is performed from the 
Level 6 and must be at the file level. 

File transmission is accomplished in a remote batch manner. 
That is, the file is not created at the IBM host until the sub¬ 
mitted job has been executed. Therefore, you should check with 
the host operator to determine if the job terminated successfully 
even if TRANB terminated abnormally, as in the case of the line 
going down after the job was transmitted but before print output 
was returned to the Level 6. In this case, the print output can 
be retrieved by transmitting a signon card: 

1. If the aborted job was being sent to the host, enter: 

TRANB SD -Lxxx (signon) -N nn -I pathname 

2. If the aborted job was being received at the Level 6, 
enter: 

TRANB RD -Lxxx (signon, no JCL) -N nn -I pathname 
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APPENDIX A 


MESSAGES 


LEVEL 6 INFORMATION MESSAGES 


The messages described in Table A-l are issued to the Level 6 
user-out file during TRANB operation. 


Table A-l. Information Messages 


Message 


Description 


TRAN yddd TRANB is executing. yddd is the 

Julian date (year, day) of the 
software revision. 


TRAN ESTABLISHED The logical connection between TRANB 

and the host has been established. 


nnnnn RECORDS TRANSFERRED The file transfer is complete, nnnnn 

is the number of records transfer¬ 
red. For a file sent to the host, 
this count includes the JCL records 
sent as well as the data records. 

For a received file, nnnnn is the 
number of data records received. 


LEVEL 6 ERROR MESSAGES 

File transmission errors are displayed on the user-out file 
as coded messages containing six hexadecimal digits beginning 
with the code number 22: 

22nnnn 

nnnn is the message code; see Table A-2. 

For additional information see the System Messages manual. 
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Table A-2. Error Messages 


Message 

2200 

2201 

2202 

2203 

2204 

2205 

2206 

2207 

2208 

2240 

2241 
22C0 
22C4 


Code Description 

General command or argument error 

Specific command error - individual operator error 

Invalid argument in the TRANB command. Check 
command line and replace incorrect value 

Specific command error - level (-L) argument 
incorrect 

Specific command error - wrong initiator (-1) 
pathname detected 

Specific command error - wrong acceptor (-&) 
identifier detected 

Specific command error - start record number (-SR) 
argument error 

Transmission error on initiate request record 
Transmission error on acceptor's answer 
Illegal character received from IBM host 
Illegal message received from IBM host 
General connection failure 
Level 6/BSC 2780/3780 connection failure 


































}Bit Positions 0,1 
}Bit Positions 2,3 
}First Hexadecimal Digit 
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